[% page.title = 'API Method: relation items list'
   page.tab = 'api'
%]

<h2>GET /:user_id/relations/:relation_id/items</h2>
<p>Returns the list of relations (items) from the specified relation with a 200 OK HTTP status code.</p>

<h3>URL:</h3>
<code>[% site.url %]/<em>user_id</em>/relations/<em>relation_id</em>/items.<em>format</em></code>

<h3>Formats (<a href="formats">about return formats</a>):</h3>
<code>[% INCLUDE 'api/_formats.phtml' %]</code>

<h3>HTTP Methods (<a href="http-methods">about HTTP methods</a>):</h3>
<code>GET</code>

<h3>Requires Authentication (<a href="authentication">about authentication</a>):</h3>
<code>true</code> &nbsp;if relation's <code>mode</code> property is set to <code>private</code><br/>
<code>false</code> &nbsp;if relation's <code>mode</code> property is set to <code>public</code>

<h3>Parameters:</h3>
<ul>
<li><code>relation_id</code>.  Required. The ID of the relation to list the items of.</li>
<li><code><em>full</em></code>.  Optional. Whether to include the <code>text</code> data in the returned representation of the item.
Values can be either <code>1</code> for true or <code>0</code> for false. The default is <code>0</code>.
<ul>
<li>Example: <code>[% site.url %]/kdd09/relations/pc/items.xml</code></li>
</ul>
</li>
</ul>

<h3>Usage Examples:</h3>
<blockquote>
<h4>cURL (<a href="curl">about cURL</a>):</h4>
<code>curl [% site.url %]/kdd09/relations/pc/items</code><br/>
</blockquote>

<h3>Response (<a href="return-values">about return values</a>):</h3>
<blockquote>
<h4>XML example:</h4>
<pre>[% FILTER html -%]
<?xml version="1.0" encoding="UTF-8"?>
<result>
  <item>
    <name>Ad Feelders</name>
    <created>1266788131</created>
    <description>Ad Feelders</description>
    <id>Ad_Feelders</id>
    <modified>1266788131</modified>
    <source>http://dblp.uni-trier.de/search/author?author=Ad%20Feelders</source>
  </item>
  <item>
    <name>Ada Fu</name>
    <created>1266788131</created>
    <description>Ada Fu</description>
    <id>Ada_Fu</id>
    <modified>1266788131</modified>
    <source>http://dblp.uni-trier.de/db/indices/a-tree/f/Fu:Ada_Wai=Chee.html</source>
  </item>
  .
  .
  .
  <item>
    <name>Zoran Obradovic</name>
    <created>1266788131</created>
    <description>Zoran Obradovic</description>
    <id>Zoran_Obradovic</id>
    <modified>1266788131</modified>
    <source>http://dblp.uni-trier.de/search/author?author=Zoran%20Obradovic</source>
  </item>
</result>
[% END %]</pre>
</blockquote>

